home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / utilit~1 / groffvar.zoo / source / porting < prev    next >
Encoding:
Text File  |  1993-03-06  |  1.8 KB  |  40 lines
  1. This file describes the porting process needed to do your own port of groff:
  2.  
  3. - Unzip, untar the archive
  4. - Run `configure'. I needed to set the environment variable LIBS to '-lg++'.
  5. - Run `config.status'.
  6. - Patch <unistd.h> if it doesn't define optarg, opterr and optind.
  7.   A patch is included.
  8. - Patch getopt.c in the mintlibs. I have included the version I used.
  9.   The problem with the normal `getopt' is that it requires a space
  10.   between an option and its parameter, and that groff does *not* include
  11.   this space when calling subcommands.
  12. - Link, symlink or copy the math library pml.olb to m.olb.
  13. - Edit Makefile.lib to add the 's' parameter to ar. I have included
  14.   the Makefile.lib I used.
  15. - Edit Makefile to set compiler parameters and defines. I have included
  16.   the Makefile I used.
  17. - Edit gendefs.sh if needed. Editing it is needed if the compiler
  18.   complains about `0201' characters during compilation. As I've included
  19.   the edited version, use the edited version just to be sure.
  20.   (Note: editing is needed because of a bug in the /bin/sh I use.)
  21. - Run `make'.
  22.  
  23. If you don't have inifite memory, gcc will run out of memory on some files,
  24. notably in the troff/ subdirectory and on pic/pic.cc, tbl/table.cc
  25. and refer/refer.cc. Just type the command line by hand, possibly leaving
  26. out the -O2 option, and it will compile fine. Now try `make' again.
  27.  
  28. - Run `make install'. This will install groff in the appropriate directories.
  29.   You *did* set the paths correctly in the Makefile, I hope? Otherwise, it
  30.   will need to recompile quite a few files...
  31.  
  32. - Write wrappers for the shell scripts and perl scripts. I have included
  33.   mine.
  34.  
  35. That's it. Oh yes, I used gcc 2.3.3, the gnulibs pl 16, the pml pl 20, and
  36. the mintlibs pl 30. Thanks to Jhawar bammi, Eric Smith, entropy and all the
  37. others for making all of this possible.
  38.  
  39. Bye, Hildo Biersma
  40.